home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / pvm34b3.zip / pvm34b3 / pvm3 / Readme < prev    next >
Text File  |  1997-07-22  |  6KB  |  171 lines
  1.  
  2.          PVM version 3.4:  Parallel Virtual Machine System
  3.                University of Tennessee, Knoxville TN.
  4.            Oak Ridge National Laboratory, Oak Ridge TN.
  5.                    Emory University, Atlanta GA.
  6.       Authors:  J. J. Dongarra, G. E. Fagg, G. A. Geist,
  7.                  J. A. Kohl, R. J. Manchek, P. Mucci,
  8.          P. M. Papadopoulos, S. L. Scott, and V. S. Sunderam
  9.                    (C) 1997 All Rights Reserved
  10.  
  11.                               NOTICE
  12.  
  13.  Permission to use, copy, modify, and distribute this software and
  14.  its documentation for any purpose and without fee is hereby granted
  15.  provided that the above copyright notice appear in all copies and
  16.  that both the copyright notice and this permission notice appear in
  17.  supporting documentation.
  18.  
  19.  Neither the Institutions (Emory University, Oak Ridge National
  20.  Laboratory, and University of Tennessee) nor the Authors make any
  21.  representations about the suitability of this software for any
  22.  purpose.  This software is provided ``as is'' without express or
  23.  implied warranty.
  24.  
  25.  PVM version 3 was funded in part by the U.S. Department of Energy,
  26.  the National Science Foundation and the State of Tennessee.
  27.  
  28. ________________________________________________________________________
  29. WHAT IS PVM?
  30.  
  31. PVM is a software system that enables a collection of heterogeneous
  32. computers to be used as a coherent and flexible concurrent computational
  33. resource.
  34.  
  35. The individual computers may be shared- or local-memory multiprocessors,
  36. vector supercomputers, specialized graphics engines, or scalar
  37. workstations, that may be interconnected by a variety of networks,
  38. such as ethernet, FDDI.
  39.  
  40. User programs written in C, C++ or Fortran access PVM through library
  41. routines.
  42.  
  43.  
  44. UNPACKING
  45.  
  46. This distribution contains source code, simple examples, and run-time
  47. support for PVM version 3.  The documentation for PVM can be obtained
  48. separately from Netlib.  To get a list of available subsets, send
  49. e-mail to "netlib@ORNL.GOV" with the subject:  "send index from pvm3".
  50.  
  51. Files in the distribution unpack in directory pvm3.  The pvm3 directory
  52. can reside in either a private or shared disk area.  Installations for
  53. multiple machine architectures can coexist because compiled files are
  54. placed in subdirectories named for each architecture (ARCH).
  55.  
  56. Some of the more important directories are:
  57.  
  58.     Directory   Contains
  59.     ---------------------------------------------------------------
  60.     bin/ARCH    PVM user program executables (the examples or your programs)
  61.     conf        Make configuration files for all PVM architectures
  62.     console     Source for the pvm console
  63.     doc         Miscellaneous documentation
  64.     examples    Example PVM program source
  65.     gexamples   More example PVM programs - for group library
  66.     hoster      An example "hoster" program
  67.     include     Header files for PVM programs
  68.     lib         Generic system executables (scripts)
  69.     lib/ARCH    System executables (pvmd, console, etc.)
  70.     libfpvm     Source for the libfpvm Fortran library
  71.     man/man[13] Online manual pages (nroff format)
  72.     misc        Some PVM examples and utilities
  73.     patches     Patch files and instructions, as they are released
  74.     pvmgs       Source for the libgpvm library and group nameserver
  75.     src         Source for the libpvm library and pvmd daemon
  76.     src/ARCH    Additional source code for specific machines
  77.     tasker      An example "tasker" program
  78.     xep         An example interactive X-Window program
  79.  
  80.  
  81. BUILDING AND INSTALLING
  82.  
  83. Before building or running PVM, you must set environment variable PVM_ROOT
  84. to the path where PVM resides, i.e. the path of this directory.  This can
  85. be in a private area, for example $HOME/pvm3, or a public one, such as
  86. /usr/local/pvm3.
  87.  
  88. If your shell is csh, add a line such as:
  89.  
  90.     setenv PVM_ROOT $HOME/pvm3
  91.  
  92. to your .cshrc file.  If you use a shell that reads .profile, such as sh
  93. or ksh, add the following lines to that file:
  94.  
  95.     PVM_ROOT=$HOME/pvm3
  96.     PVM_DPATH=$PVM_ROOT/lib/pvmd
  97.     export PVM_ROOT PVM_DPATH
  98.  
  99. The use of these variables is explained more fully in the pvm_intro man
  100. page.
  101.  
  102. Type "make" in this directory.  Make will use aimk to build the daemon
  103. executable (pvmd3), C library (libpvm3.a), Fortran library (libfpvm3.a)
  104. and console client program (pvm).
  105.  
  106. The libraries and executables are installed in $PVM_ROOT/lib/ARCH/, where
  107. ARCH is the host architecture name, e.g. "CRAY".
  108.  
  109. The scripts $PVM_ROOT/lib/pvm and $PVM_ROOT/lib/pvmd are used,
  110. respectively, to start the PVM console and pvmd.  They determine the
  111. machine architecture and run the actual programs in $PVM_ROOT/lib/ARCH.
  112. You can either copy these scripts to your bin directory or add
  113. $PVM_ROOT/lib to your shell search path.
  114.  
  115. You may wish to add $PVM_ROOT/man to your MANPATH environment variable,
  116. if it's supported on your system.  This will allow you to easily read
  117. the online manual pages.
  118.  
  119.  
  120. STARTING AND STOPPING PVM
  121.  
  122. To start PVM, run $PVM_ROOT/lib/pvm.  This starts the console task, which
  123. in turn starts a pvmd if one is not already running.  More hosts can be
  124. started by using the console "add" command.
  125.  
  126. To stop PVM, use the PVM console command "halt".  From programs, use the
  127. pvm_halt() function.  You can also kill the pvmd (always use a catchable
  128. signal).
  129.  
  130. For more information about the console commands, see the console "help"
  131. function or console man page.
  132.  
  133. To start the pvmd without starting the console, run pvm3/lib/pvmd .
  134. A number of hosts can be started by supplying the pvmd with a host
  135. file.
  136.  
  137.  
  138. APPLICATION PROGRAMS
  139.  
  140. C, C++ and Fortran programs must be linked with pvm3/lib/ARCH/libpvm3.a .
  141. Fortran programs must also be linked with pvm3/lib/ARCH/libfpvm3.a .
  142. Include C/C++ header file pvm3/include/pvm3.h for constants and function
  143. prototypes.  Fortran header file is in pvm3/include/fpvm3.h.
  144.  
  145. Executables should be installed in pvm3/bin/ARCH .  This path can be
  146. changed; see the pvmd man page.
  147.  
  148.  
  149. CONTACT
  150.  
  151. The PVM web home page is at
  152.  
  153.     http://www.epm.ornl.gov/pvm/pvm_home.html .
  154.  
  155. A newsgroup, comp.parallel.pvm, exists for discussion about PVM
  156. and help with problems.
  157.  
  158. Please direct any e-mail (questions, bugs, bug fixes, etc.) to:
  159.  
  160.     pvm@msr.EPM.ORNL.GOV.
  161.  
  162. To report bugs or problems with PVM, please see the file
  163.  
  164.     $PVM_ROOT/doc/bugreport .
  165.  
  166. ________________________________________________________________________
  167.  
  168. Sincerely,
  169. The PVM research group
  170.  
  171.